package cn.tedu.wms.passport.service;


import cn.tedu.wms.passport.pojo.dto.RoleAddNewDTO;
import cn.tedu.wms.passport.pojo.dto.RoleUpdateDTO;
import cn.tedu.wms.passport.pojo.vo.RoleListItemVO;
import cn.tedu.wms.passport.pojo.vo.RoleStandardVO;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

/**
 * 处理角色数据的业务接口
 *
 * @author 刘哲兮
 * @version 0.0.1
 */
@Transactional
public interface IRoleService {

    /**
     * 添加角色
     *
     * @param roleAddNewDTO 角色数据
     */
    void addNew(RoleAddNewDTO roleAddNewDTO);

    /**
     * 删除角色
     *
     * @param id 尝试删除的角色的id
     */
    void delete(Long id);

    /**
     * 根据角色id，修改角色详情
     *
     * @param id             库存id
     * @param roleUpdateDTO 新的角色数据
     */
    void updateInfoById(Long id, RoleUpdateDTO roleUpdateDTO);

    /**
     * 根据id获取角色的标准信息
     *
     * @param id 角色id
     * @return 返回匹配的角色的标准信息，如果没有匹配的数据，将返回null
     */
    RoleStandardVO getStandardById(Long id);

    /**
     * 查询角色列表
     *
     * @return 角色列表
     */
    List<RoleListItemVO> list();

}
